home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / aicnf111.zip / AICONFIG.TXT < prev   
Text File  |  1992-06-15  |  20KB  |  538 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                A   I   C   O   N   F   I   G
  28.  
  29.                (A Smart Conference Setup Utility for PCB 14.5a)
  30.  
  31.  
  32.                Version 1.11          06/15/1992
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                by: Keith Luken
  45.                    PHANTASM Software
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                  A I C O N F I G
  54.  
  55.  
  56.      INTRODUCTION 
  57.  
  58.           AICONFIG is a utility  for PCBoard(tm) SYSOP's to help  in making
  59.      configuration  changes to conferences. With  the advent of  PCB 14.5 a
  60.      SYSOP  can  now support  more than  39  conferences within  PCB itself
  61.      without the  use of DOORS such as PRODOOR. One nice feature in PRODOOR
  62.      that is  unfortunately missing( at least  for now) in PCB  14.5 is the
  63.      ability  to GLOBALLY  update  conference  fields.  Well  that  is  how
  64.      AICONFIG was born. The need to make changes to numerous conferences at
  65.      once  can be a  tedious and time  consuming job under  PCB if you have
  66.      numerous conferences. AICONFIG is  a FLEXIBLE utility to allow  you to
  67.      make GLOBAL or partial GLOBAL changes to your conference configuration
  68.      without  all the time and  typing! AICONFIG supports  updating a field
  69.      with just  the DRIVE,  DRIVE/PATH, FILENAME,  or FULL  DRIVE,PATH, and
  70.      FILENAME  across one, some or ALL conferences! In addition to changing
  71.      file names  it allow  global updating of  the other status  flags. And
  72.      when updating a file name field you have  the option to copy that file
  73.      to it's new name/location. 
  74.  
  75.      REQUIREMENTS
  76.  
  77.           AICONFIG  will  support up  to  32767 conferences(including  MAIN
  78.      BOARD). AICONFIG  will run  on any  IBM or  compatible system  with at
  79.      least 256K  of  RAM. The  more conferences  you have  the more  memory
  80.      AICONFIG needs to operate. AICONFIG itself uses approximately 120K  of
  81.      memory with conferences requiring an additional 32 bytes of memory per
  82.      conference.  AICONFIG leaves  16K  of additional  RAM  as work  space.
  83.      AICONFIG   automatically   determines   your   monitor   and   adjusts
  84.      accordingly. AICONFIG requires enough  free disk space as the  size of
  85.      your  present CNAMES.@@@  file  to use  as  work space  while you  are
  86.      editing the conferences.
  87.  
  88.      FULL SUPPORT
  89.  
  90.           I have made every attempt to thoroughly test and debug this code.
  91.      Since  I  can not  possibly duplicate  every  type of  environment and
  92.      configuration  there is always the possibility of a remaining quirk or
  93.      two. Unregistered copies will  be supported as my time  permits, while
  94.      REGISTERED copies  get full support and if the problem is with my code
  95.      and cannot be  resolved then a  refund will be  made! Support will  be
  96.      given via my BBS which can be reached at (908) 291-2302  (USR DUAL) or
  97.      at (908) 291-4134 (HAYES ULTRA). AICONFIG is written in BASIC 7.1 with
  98.      the help  of some excellent assembler routines from QUICK PAK PRO from
  99.      Crescent Software! 
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.      1                                            (C)1992 PHANTASM Software
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                                  A I C O N F I G
  115.  
  116.      WARRANTY
  117.  
  118.           Well here is that legal disclaimer you all know all too well-
  119.      I  supply AICONFIG with NO warranty either expressed or implied! While
  120.      I  have made  every effort  possible to assure  the integrity  of this
  121.      program I can NOT be and will NOT be liable for any damage incurred by
  122.      the use or misuse of this program. Due to the possibility of a virus I
  123.      can only suggest  that to keep the highest integrity possible that you
  124.      get AICONFIG from my BBS or those mentioned in this document.
  125.      The  latest version of AICONFIG can  be found on my BBS  or any of the
  126.      following:
  127.           Modem Zone(HST)     (513) 424-7529     
  128.           Vernon(HST)         (201) 827-6441
  129.           Arrackis(HST)       (908) 730-7328
  130.  
  131.      FEEDBACK
  132.  
  133.           I  am extremely  interested  in anyone  who  wishes to  try  this
  134.      program and would greatly appreciate ANY feedback  GOOD or BAD! If you
  135.      have any suggestions for future features or improvements please let me
  136.      know.  I can  be  reached on  my BBS  listed  in this  document  or on
  137.      Intelec(tm)  at ID PHANTASM. Mail through E-MAIL should be left either
  138.      in the SYSOP or ADMIN conference.
  139.  
  140.      GETTING STARTED
  141.  
  142.           AICONFIG is  rather straight forward and contains online help for
  143.      proper  usage of  commands.  AICONFIG and  it's  associated files  can
  144.      reside anywhere on  your system.  AICONFIG should be  located and  run
  145.      from the directory  where your  CNAMES.@@@ file  is, but  that is  not
  146.      mandatory.  Simply copy the files to  the directory you choose and you
  147.      are  all set.  to run AICONFIG  just type  in AICONFIG  and hit enter.
  148.      AICONFIG is smart enough to know where it was  run from so it can find
  149.      it's  associated  files  even if  run  from  a directory  that  is not
  150.      current.  AICONFIG  will  look  in  the  CURRENT  directory  for  your
  151.      CNAMES.@@@ file. If the CNAMES.@@@  file is NOT located an error  will
  152.      occur unless you tell AICONFIG on the command line where to find it. 
  153.      To tell AICONFIG  where to find  your CNAMES.@@@ file  just add a  /C:
  154.      switch followed by the drive/path/filename of CNAMES.@@@.
  155.           ex. AICONFIG /C:L:\PCB\MAIN\CNAMES.@@@
  156.      The /C: switch MUST be the last  switch used on the command line. This
  157.      is the only switch that must be in a specific location. Other switches
  158.      may  be in  any order  prior to  the /C:  switch.  If for  some reason
  159.      AICONFIG does not properly  sense a monochrome monitor on  your system
  160.      you may  add the /MONO  switch to the  command line to  force AICONFIG
  161.      into  monochrome  operation.  If  you have  registered  your  copy  of
  162.      AICONFIG and have received a key number you may generate a key file by
  163.      entering the /REGISTER switch to enter your key number.
  164.  
  165.  
  166.  
  167.      2                                            (C)1992 PHANTASM Software
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                                  A I C O N F I G
  176.  
  177.      USING AICONFIG
  178.  
  179.           Once you have started AICONFIG from the command line you will see
  180.      an  opening  screen   which  shows  the  version  number   along  with
  181.      registration  information. Registered copies  have all  delays removed
  182.      and perform  much faster  than unregistered copies.  Also unregistered
  183.      copies  will only  make  changes on  the  first 100  conferences.  All
  184.      information for conferences above 100 will be  preserved as is and not
  185.      altered  by AICONFIG unless your copy is registered. After the opening
  186.      screen AICONFIG will inform you that it is making a work file for your
  187.      CNAMES.@@@  file. To  prevent changes  from immediately  altering your
  188.      CNAMES.@@@ file and losing  your previous configuration AICONFIG makes
  189.      a working copy of it and changes are made to that file until  you save
  190.      it at the end  of operation. Once the work file is  made AICONFIG will
  191.      display that  main board information in a  manner very similar to that
  192.      of PCBoard's own setup.  You navigate around the conference  fields by
  193.      using the TAB, ENTER and/or CURSOR Keys. To switch between conferences
  194.      you use the (CTRL)PG-UP or (CTRL)PG-DN key combinations to move either
  195.      on conference or 20 conferences. 
  196.           While  in any  field  hitting the  F1  key will  display a  short
  197.      description of  what that  field is used  for and  if appropriate  the
  198.      possible  choices or  ranges for  that field.  Hitting  F2 while  in a
  199.      conference displays a  list of  the AICONFIG commands  and the  proper
  200.      keys  to  activate them.  The  individual  AICONFIG commands  will  be
  201.      described in detail later in  this manual. It should be noted  that if
  202.      you make changes to a field and then move to  another conference those
  203.      changes are written  to the work file. This is  important since if you
  204.      select a command to  copy a file AICONFIG uses the  name stored in the
  205.      work file as the source, so select the copy command before leaving the
  206.      conference you wish to copy. 
  207.           When you select  a configuration command for AICONFIG  to perform
  208.      you are presented with a message asking if you want that command to be
  209.      performed on ALL conferences or  to TAG the conferences to  make these
  210.      changes  to. If  you select  YES to  perform on  ALL  conferences then
  211.      AICONFIG will go  ahead and make those changes to  ALL conferences. If
  212.      you select  NO then  you will  be presented  with a  menu of  all your
  213.      conferences and may use the ENTER or SPACE keys to TAG conferences for
  214.      update. PG-UP and PG-DN  moves 40 conferences in either  direction. If
  215.      you have previously TAGGED conferences during this session of AICONFIG
  216.      you  will be asked if you want to CLEAR PREVIOUS TAGS. This allows you
  217.      to tag numerous conferences  and make individual field changes  to the
  218.      same set of conferences each time  to prevent missing amy. If you keep
  219.      previous TAGS  you may also add  new TAGs at this  time without losing
  220.      the previously  tagged conferences. If you are copying a file you will
  221.      be asking  if the  source file  should be  deleted after a  successful
  222.      copy. This allows you to in essence move the file without having to go
  223.      back and do a lot of file maintenance.
  224.  
  225.  
  226.  
  227.  
  228.      3                                            (C)1992 PHANTASM Software
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                  A I C O N F I G
  237.  
  238.  
  239.           When AICONFIG is done with the updates for the field you selected
  240.      you are then left back at  the conference and field where you selected
  241.      the AICONFIG command. When you are done with the updates you desire to
  242.      make you simply hit the ESC  key and AICONFIG will ask if you  wish to
  243.      save the  changes. Answering YES will  now copy the work  file back to
  244.      CNAMES.@@@   and  then   create  a   corresponding  CNAMES   file  for
  245.      compatibility  and use with PCBoard's own setup utility. If you answer
  246.      NO then  AICONFIG will  delete the  work file and  do nothing  to your
  247.      CNAMES.@@@ or CNAMES files.
  248.  
  249.      WARNING!
  250.  
  251.           The CURSOR  MUST be in the  field to be updated  before you enter
  252.      AICONFIG COMMAND KEY(s) or the wrong  field will be updated! This is a
  253.      common  problem on the single  character fields or  when you use every
  254.      space  in a field since the editor moves to the next field when one is
  255.      filled.I have  made every attempt  to trap  most common errors  and to
  256.      inform  you if one occurs. AICONFIG expects filename fields to contain
  257.      a  VALID DRIVE, PATH and  NAME. If the target  of source are not valid
  258.      then AICONFIG will  not perform the copy functions,  a field without a
  259.      valid target  name  will show  an  error, but  if  you answer  YES  to
  260.      continue  the new  field  information  will  NOT  be  written  to  the
  261.      conference configuration. Most errors occurring  during operation will
  262.      display an error message asking if you wish to continue. Some critical
  263.      operational errors will  terminate the program  regardless of how  you
  264.      answer and only post the error  for your own information. If the error
  265.      will allow the  program to continue then only that function is skipped
  266.      on that conference.
  267.  
  268.      REGISTER
  269.           Once  you  have registered  your  copy of  AICONFIG  simply start
  270.      AICONFIG  with   the  /REGISTER  switch.   This  will  bring   up  the
  271.      registration screen.  While  AICONFIG will  find it's  own files  from
  272.      wherever you start it, the registration procedure will generate in the
  273.      current drive  and directory! Registered  copies can process  have the
  274.      100 conference limit and all delays between conferences removed!
  275.  
  276.      MAIN BOARD
  277.           AICONFIG  shows every  conference  including the  MAIN BOARD  the
  278.      same.  Some  fields  are not  used  by  PCBoard  in  the MAIN  BOARD's
  279.      configuration.  Fields not used by PCBoard  for the MAIN BOARD will be
  280.      always saved at their normal DEFAULT. This will not affect any  GLOBAL
  281.      changes you make while in those fields, but  will be saved to the work
  282.      file for the main board as their normal default.
  283.  
  284.  
  285.  
  286.             
  287.  
  288.  
  289.      4                                            (C)1992 PHANTASM Software
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.                                  A I C O N F I G
  298.  
  299.      COMMANDS
  300.  
  301.      GLOBAL UPDATE of CURRENT FIELD (F3)
  302.                This command will take the changes made in the current field
  303.      and  applies  them globally  across  ALL or  SELECTED  conferences. No
  304.      checking of file existence or path  existence is made and changes  are
  305.      made with  no verification in any  way. This is the  ONLY command that
  306.      can be used on Non-File Fields!
  307.  
  308.      COPY OLD FIELD FILE to NEW FIELD FILE (F4)
  309.                This command will take the changes made in the current field
  310.      and  applies them  to  the PRESENT  conference  ONLY. In  addition  to
  311.      updating the conferences configuration AICONFIG will take the OLD file
  312.      (from the  work  file)  and copy  it  to  the  NEW file  made  in  the
  313.      conference configuration. If the  source file for a conference  is not
  314.      found or  the target path/name  is invalid  then it will  not will  be
  315.      copied.  If  the target  path  does  not  exist  it  will  be  created
  316.      automatically.
  317.  
  318.      GLOBAL COPY OLD FIELD FILE to NEW FIELD FILE (F5)
  319.                This command will take the changes made in the current field
  320.      and applies  them  GLOBALLY across  ALL  or SELECTED  conferences.  In
  321.      addition to  updating the  conference(s)  configuration AICONFIG  will
  322.      take the OLD  file (from the work  file) and copy  it to the NEW  file
  323.      made  in  the  conference configuration.  If  the  source  file for  a
  324.      conference  is not  found  or the  target  path/name is  invalid  that
  325.      conference will be skipped. If the  target path does not exist it will
  326.      be created automatically.
  327.  
  328.      (FULL PATH/NAME)
  329.                This option  for a  AICONFIG command will  take the  changes
  330.      made to the  entire field  of a conference  and apply  them to ALL  or
  331.      SELECTED conference(s). 
  332.  
  333.      (DRIVE/PATH ONLY)
  334.                This option for a command  will take only the NEW DRIVE  and
  335.      the NEW PATH entered  in a field and apply it to the OLD file name for
  336.      ALL or SELECTED conference(s). 
  337.  
  338.      (FILENAME ONLY)
  339.                This  option for a command  will take only  the NEW FILENAME
  340.      for the entered field and apply it  to the OLD DRIVE and OLD PATH  for
  341.      ALL or SELECTED conference(s).
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.      5                                            (C)1992 PHANTASM Software
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.                                  A I C O N F I G
  359.  
  360.  
  361.      *HISTORY*
  362.  
  363.      Version 1.00   01/29/1991
  364.           - Initial Release
  365.  
  366.      Version 1.01   01/31/1991
  367.           - Fixed Copy file info flashing too quickly over conference name.
  368.           - Added skipping conferences with no names when updating.
  369.  
  370.      Version 1.02   06/23/1991
  371.           - Fixed incompatability with some changes made in 14.5a CNAMES file
  372.           - Added prompt if ESC is hit while editing if you really want to end
  373.  
  374.      Version 1.10   12/03/1991
  375.           - Fixed problem if data was changed in a field and conference
  376.             was changed while still in field, data was not saved.
  377.           - Fixed problem with global updating of the PUBLIC/PRIVATE upload
  378.             file locations
  379.  
  380.      Version 1.11   06/15/1992
  381.           - Recompiled and updated text to reflect my new address
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      6                                            (C)1992 PHANTASM Software
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.                                  A I C O N F I G
  423.  
  424.      REGISTERED OWNER REFERRAL DISCOUNT
  425.  
  426.              PAID  Registered  owners   of  AICONFIG  automatically  become
  427.      eligible for commissions of referral sales of AICONFIG! When you refer
  428.      a new REGISTRATION of  AICONFIG and that person submits  your name and
  429.      serial number you will receive a $5 rebate on that registration! There
  430.      is a $50  limit on the total rebates  you can receive. If you  get the
  431.      max it's like getting paid $25 for registering your copy! WOW! Getting
  432.      paid to use shareware! So spread the word about AICONFIG and make some
  433.      money while you're at it!
  434.  
  435.      MULTIPLE DISCOUNT PROGRAM
  436.  
  437.      Registering any one product from PHANTASM Software entitles you to    
  438.      discounts on any additional products at large  savings! The first     
  439.      product registration is $25 and each additional product  can be       
  440.      registered for $10. This is available on any present or future        
  441.      PHANTASM Software products unless otherwise stated in the products    
  442.      documentation.
  443.  
  444.  
  445.      REGISTRATION
  446.  
  447.              Registering  AICONFIG  will  assure  you  of  having  a  fully
  448.      featured copy!
  449.  
  450.              AICONFIG  will  only  be FULLY  featured  to  those  that have
  451.      registered it! To register your AICONFIG send a check for $25 made out
  452.      to :                          Keith Luken
  453.              at the below address. Please fill out all of the
  454.              information below and enclose with your check! Thanks!
  455.  
  456.                               Send $25 to:
  457.                                              Keith Luken
  458.                                              3930 Shoemaker Court
  459.                                              Marietta, GA 30062
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.      7                                            (C)1992 PHANTASM Software
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.                                  A I C O N F I G
  484.  
  485.  
  486.  
  487.      Name - ________________________________________ Age-_________________
  488.  
  489.  
  490.      EXACT Name of person to show on registration -________________________
  491.  
  492.  
  493.      BBS Name and Phone # - ______________________(      )_____-___________
  494.  
  495.  
  496.      ADDRESS - ____________________________________________________________
  497.  
  498.  
  499.      City - _____________________________ ST - _________ ZIP - ____________
  500.  
  501.  
  502.      PRODUCT TO REGISTER -_________________________________________________
  503.  
  504.  
  505.      Pick one: For this program I feel $25 is -     ______ Too Much
  506.  
  507.                                                     ______ About Right
  508.  
  509.                                                     ______ A Bargain
  510.  
  511.  
  512.      Comments/Suggestions - _______________________________________________
  513.  
  514.  
  515.      ______________________________________________________________________
  516.  
  517.  
  518.      REGISTERED OWNER REFERRAL DISCOUNT INFO -
  519.  
  520.  
  521.      NAME OF REGISTERED REFERRAL - ________________________________________
  522.  
  523.  
  524.      REFERRAL USER's SERIAL NUMBER - ______________________________________
  525.  
  526.  
  527.      MULTIPLE DISCOUNT INFO -
  528.  
  529.  
  530.      PREVIOUSLY REGISTERED PRODUCT(s) - ___________________________________
  531.  
  532.  
  533.      ADDITIONAL PRODUCTS TO REGISTER NOW - ________________________________
  534.  
  535.  
  536.      8                                            (C)1992 PHANTASM Software
  537.  
  538.